home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / utils / graphic / viewers / general / amiga / he / read.me < prev    next >
Encoding:
Text File  |  1991-02-24  |  2.9 KB  |  54 lines
  1.     HE        (great name, huh?)
  2.     
  3.     This is a simple little IFF picture viewer with support for 
  4. pictures larger than the screen.  So what?  Well, it also handles
  5. HAM-E pictures.  No big deal, since they're just hi-res pics, right?
  6.     Well, sort-of.  They are indeed IFF pictures, and can be shown
  7. with any picture viewer, but there is a problem.  The HAM-E is 
  8. triggered by the "magic cookie", which is contained in the first few
  9. lines of the picture.  So, if you scroll the picture around, the
  10. magic cookie gets moved offscreen, and the HAM-E unlocks.  Not cool.
  11.     Enter this viewer.  It can view just about any IFF picture you 
  12. can throw at it.  And if it detects a HAM-E picture, it will grab the
  13. cookie and keep it visible at all times while you scroll around.
  14. Pretty simple, really.
  15.     If you're running under WorkBench 2.0x, the pictures will be
  16. displayed in overscan when necessary.  This is so trivial to do under 
  17. 2.0x that I figured I might as well.  It's a lot more work under 1.3,
  18. so I didn't bother.  You have to understand that this whole program
  19. was done on a "whim", and I only allowed it to take a couple of hours
  20. of my time...
  21.     I have included the source just so that struggling programmers
  22. can use it as an example.  Note that the iff_stuff.c file contains a 
  23. lot of routines that are not used in this particular program.  That
  24. file is my generic IFF handler stuff, and I didn't feel like paring it
  25. down to only the relevant stuff for this program.  (There are routines
  26. in there for pictures, sounds, etc.)  
  27.     Future features?  I'd like to see color cycling support, and 
  28. maybe anim support, but I just don't have the time.  Later, maybe...
  29.     As far as the legal issues go...   Anyone who wants to use this
  30. code in a non-commercial product is free to do so.  I do request a copy
  31. of such a product, though.  Commercial uses are not permitted without
  32. contacting me first (I will almost certainly grant permission, I just
  33. want to know about things beforehand.)  You may distribute this program
  34. as long as the source code is included, but may not make any profit
  35. from it other than the cost of the media it is on.
  36.     HE works from the CLI only (sorry...) and is childishly simple
  37. to operate.  Just say "HE [-n] <filename>".  Once up and running, you
  38. click and drag the left mouse button to scroll around, and the right 
  39. button to quit.  Pretty simple, eh?
  40.     The [-n] option will disable overscan under 2.0.  For some reason,
  41. I have yet to be able to set my overscan preferences such that the 
  42. HAM-E will lock on a severely overscanned image under 2.0.  This 
  43. provides a simple, if inelegant, way to get around that.          
  44.     I do not request any donation for the use of this program (other
  45. than for use of the source, as noted above).  But if you want to 
  46. contact me for any reason, send your comments, flames, and hard drives
  47. of outrageous capacity to:
  48.     
  49.             Robert Kesterson
  50.             6418 30th Street
  51.             Lubbock, TX 79407
  52.             (806)-792-3639
  53.             BIX: rkesterson
  54.